From 7fed66df42925297eb71f6af7955a651195d4d98 Mon Sep 17 00:00:00 2001 From: Jonathan Blandford Date: Thu, 22 Jan 2004 06:48:20 +0000 Subject: [PATCH] new introduction section. Thu Jan 22 01:46:45 2004 Jonathan Blandford * gtk/tmpl/gtktreemodelsort.sgml: new introduction section. --- docs/reference/ChangeLog | 4 + .../gdk-pixbuf/tmpl/file-loading.sgml | 11 ++ .../gdk-pixbuf/tmpl/file-saving.sgml | 60 ++++++++++ .../gdk-pixbuf/tmpl/gdk-pixbuf-loader.sgml | 4 +- .../gdk-pixbuf/tmpl/module_interface.sgml | 1 + docs/reference/gdk/tmpl/gdkdisplay.sgml | 18 +++ docs/reference/gdk/tmpl/gdkscreen.sgml | 48 ++++++++ docs/reference/gdk/tmpl/threads.sgml | 9 ++ docs/reference/gdk/tmpl/windows.sgml | 18 +++ docs/reference/gdk/tmpl/x_interaction.sgml | 10 ++ docs/reference/gtk/tmpl/gtk-unused.sgml | 16 +++ docs/reference/gtk/tmpl/gtkaction.sgml | 71 ++++++++++-- docs/reference/gtk/tmpl/gtkactiongroup.sgml | 90 +++++++++++++++ docs/reference/gtk/tmpl/gtkbutton.sgml | 30 +++++ docs/reference/gtk/tmpl/gtkcelllayout.sgml | 1 + docs/reference/gtk/tmpl/gtkcellrenderer.sgml | 7 ++ .../gtk/tmpl/gtkcellrenderertext.sgml | 15 +++ docs/reference/gtk/tmpl/gtkclipboard.sgml | 1 + docs/reference/gtk/tmpl/gtkmenushell.sgml | 8 ++ docs/reference/gtk/tmpl/gtkmessagedialog.sgml | 9 ++ docs/reference/gtk/tmpl/gtknotebook.sgml | 6 + docs/reference/gtk/tmpl/gtkpaned.sgml | 18 +++ docs/reference/gtk/tmpl/gtkradioaction.sgml | 18 +++ docs/reference/gtk/tmpl/gtksettings.sgml | 5 + docs/reference/gtk/tmpl/gtktoggleaction.sgml | 12 ++ docs/reference/gtk/tmpl/gtktoolbar.sgml | 6 + docs/reference/gtk/tmpl/gtktreemodelsort.sgml | 109 +++++++++++++++++- docs/reference/gtk/tmpl/gtktreeview.sgml | 5 + docs/reference/gtk/tmpl/gtkuimanager.sgml | 44 +++++++ docs/reference/gtk/tmpl/gtkwindow.sgml | 23 ++++ docs/reference/gtk/tree_widget.sgml | 53 ++++----- 31 files changed, 685 insertions(+), 45 deletions(-) diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 4bfea258ca..8488675ac8 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,7 @@ +Thu Jan 22 01:46:45 2004 Jonathan Blandford + + * gtk/tmpl/gtktreemodelsort.sgml: new introduction section. + 2004-01-20 Federico Mena Quintero * gtk/gtk-sections.txt: Added gtk_paned_get_child[12]. diff --git a/docs/reference/gdk-pixbuf/tmpl/file-loading.sgml b/docs/reference/gdk-pixbuf/tmpl/file-loading.sgml index 8ec39c5913..2c046580b2 100644 --- a/docs/reference/gdk-pixbuf/tmpl/file-loading.sgml +++ b/docs/reference/gdk-pixbuf/tmpl/file-loading.sgml @@ -52,3 +52,14 @@ End: @Returns: + + + + + +@filename: +@width: +@height: +@Returns: + + diff --git a/docs/reference/gdk-pixbuf/tmpl/file-saving.sgml b/docs/reference/gdk-pixbuf/tmpl/file-saving.sgml index df21532d66..dc6ececac0 100644 --- a/docs/reference/gdk-pixbuf/tmpl/file-saving.sgml +++ b/docs/reference/gdk-pixbuf/tmpl/file-saving.sgml @@ -57,3 +57,63 @@ will fail with the same error. @data: user data passed to gdk_pixbuf_save_to_callback(). @Returns: %TRUE if successful, %FALSE (with @error set) if failed. @Since: 2.4 + + + + + + + +@pixbuf: +@save_func: +@user_data: +@type: +@error: +@Varargs: +@Returns: + + + + + + + +@pixbuf: +@save_func: +@user_data: +@type: +@option_keys: +@option_values: +@error: +@Returns: + + + + + + + +@pixbuf: +@buffer: +@buffer_size: +@type: +@error: +@Varargs: +@Returns: + + + + + + + +@pixbuf: +@buffer: +@buffer_size: +@type: +@option_keys: +@option_values: +@error: +@Returns: + + diff --git a/docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-loader.sgml b/docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-loader.sgml index 7fd47cac2a..d15fd4a35f 100644 --- a/docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-loader.sgml +++ b/docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-loader.sgml @@ -80,13 +80,13 @@ fields. -@gdkpixbufloader: +@gdkpixbufloader: -@gdkpixbufloader: +@gdkpixbufloader: @arg1: @arg2: @arg3: diff --git a/docs/reference/gdk-pixbuf/tmpl/module_interface.sgml b/docs/reference/gdk-pixbuf/tmpl/module_interface.sgml index c6e56b89dd..794384d6ef 100644 --- a/docs/reference/gdk-pixbuf/tmpl/module_interface.sgml +++ b/docs/reference/gdk-pixbuf/tmpl/module_interface.sgml @@ -294,6 +294,7 @@ is loaded and must set the function pointers of the #GdkPixbufModule. @load_increment: continues an incremental load. @load_animation: loads an animation from a file. @save: saves a #GdkPixbuf to a file. +@save_to_callback: diff --git a/docs/reference/gdk/tmpl/gdkdisplay.sgml b/docs/reference/gdk/tmpl/gdkdisplay.sgml index 3343286e55..a7cf8e857c 100644 --- a/docs/reference/gdk/tmpl/gdkdisplay.sgml +++ b/docs/reference/gdk/tmpl/gdkdisplay.sgml @@ -213,6 +213,15 @@ of an X display. All its fields are private and should not be accessed directly. @msec: + + + + + +@display: +@distance: + + @@ -306,3 +315,12 @@ Applications should never have any reason to use this facility @height: + + + + + +@display: +@Returns: + + diff --git a/docs/reference/gdk/tmpl/gdkscreen.sgml b/docs/reference/gdk/tmpl/gdkscreen.sgml index 78baeab6b2..cb581a0985 100644 --- a/docs/reference/gdk/tmpl/gdkscreen.sgml +++ b/docs/reference/gdk/tmpl/gdkscreen.sgml @@ -254,3 +254,51 @@ when GDK gets multihead support. @Returns: + + + + + +@screen: +@working_directory: +@argv: +@envp: +@flags: +@child_setup: +@user_data: +@child_pid: +@error: +@Returns: + + + + + + + +@screen: +@working_directory: +@argv: +@envp: +@flags: +@child_setup: +@user_data: +@child_pid: +@standard_input: +@standard_output: +@standard_error: +@error: +@Returns: + + + + + + + +@screen: +@command_line: +@error: +@Returns: + + diff --git a/docs/reference/gdk/tmpl/threads.sgml b/docs/reference/gdk/tmpl/threads.sgml index c4f8d69eea..d0beda99e7 100644 --- a/docs/reference/gdk/tmpl/threads.sgml +++ b/docs/reference/gdk/tmpl/threads.sgml @@ -291,3 +291,12 @@ used directly — consider it private. + + + + + +@enter_fn: +@leave_fn: + + diff --git a/docs/reference/gdk/tmpl/windows.sgml b/docs/reference/gdk/tmpl/windows.sgml index bb7ec04ff5..cbe2ca93b4 100644 --- a/docs/reference/gdk/tmpl/windows.sgml +++ b/docs/reference/gdk/tmpl/windows.sgml @@ -741,6 +741,15 @@ Registers a window as a potential drop destination. @override_redirect: + + + + + +@window: +@accept_focus: + + @@ -1220,6 +1229,15 @@ Like the X Window System, GDK supports 8 modifier keys and 5 mouse buttons. @leader: + + + + + +@window: +@Returns: + + diff --git a/docs/reference/gdk/tmpl/x_interaction.sgml b/docs/reference/gdk/tmpl/x_interaction.sgml index 867eab1046..d338188af1 100644 --- a/docs/reference/gdk/tmpl/x_interaction.sgml +++ b/docs/reference/gdk/tmpl/x_interaction.sgml @@ -507,6 +507,16 @@ Since: 2.2 @display: + + + + + +@display: +@event_base: +@n_events: + + diff --git a/docs/reference/gtk/tmpl/gtk-unused.sgml b/docs/reference/gtk/tmpl/gtk-unused.sgml index 29f11c95a3..a46656dd00 100644 --- a/docs/reference/gtk/tmpl/gtk-unused.sgml +++ b/docs/reference/gtk/tmpl/gtk-unused.sgml @@ -550,6 +550,22 @@ This is a private struct used by GTK+ internally, don't worry about it. @old_accel_key: @old_accel_mods: + + + + + +@action: the object which received the signal. +@widget: + + + + + + +@action: the object which received the signal. +@widget: + Define a function pointer. Deprecated. diff --git a/docs/reference/gtk/tmpl/gtkaction.sgml b/docs/reference/gtk/tmpl/gtkaction.sgml index 59bcd796f8..fb425ead82 100644 --- a/docs/reference/gtk/tmpl/gtkaction.sgml +++ b/docs/reference/gtk/tmpl/gtkaction.sgml @@ -62,22 +62,11 @@ and should not be accessed directly. @action: the object which received the signal. - + -@action: the object which received the signal. -@widget: - - - - - - -@action: the object which received the signal. -@widget: - @@ -123,6 +112,28 @@ and should not be accessed directly. + + + + + + + + + + + + + + + +@name: +@label: +@tooltip: +@stock_id: +@Returns: + + @@ -132,6 +143,42 @@ and should not be accessed directly. @Returns: + + + + + +@action: +@Returns: + + + + + + + +@action: +@Returns: + + + + + + + +@action: +@Returns: + + + + + + + +@action: +@Returns: + + diff --git a/docs/reference/gtk/tmpl/gtkactiongroup.sgml b/docs/reference/gtk/tmpl/gtkactiongroup.sgml index 6dd50153a9..6ec1b5fea0 100644 --- a/docs/reference/gtk/tmpl/gtkactiongroup.sgml +++ b/docs/reference/gtk/tmpl/gtkactiongroup.sgml @@ -40,11 +40,55 @@ members and should not be accessed directly. + + + + + +@actiongroup: the object which received the signal. +@arg1: +@widget: + + + + + + +@actiongroup: the object which received the signal. +@arg1: +@widget: + + + + + + +@actiongroup: the object which received the signal. +@arg1: + + + + + + +@actiongroup: the object which received the signal. +@arg1: + + + + + + + + + + + @@ -63,6 +107,42 @@ members and should not be accessed directly. @Returns: + + + + + +@action_group: +@Returns: + + + + + + + +@action_group: +@sensitive: + + + + + + + +@action_group: +@Returns: + + + + + + + +@action_group: +@visible: + + @@ -91,6 +171,16 @@ members and should not be accessed directly. @action: + + + + + +@action_group: +@action: +@accelerator: + + diff --git a/docs/reference/gtk/tmpl/gtkbutton.sgml b/docs/reference/gtk/tmpl/gtkbutton.sgml index 4b5c0be256..e80b7722ac 100644 --- a/docs/reference/gtk/tmpl/gtkbutton.sgml +++ b/docs/reference/gtk/tmpl/gtkbutton.sgml @@ -97,6 +97,16 @@ mouse cursor is. + + + + + + + + + + @@ -292,3 +302,23 @@ Returns the current relief style of the given #GtkButton. @Returns: + + + + + +@button: +@xalign: +@yalign: + + + + + + + +@button: +@xalign: +@yalign: + + diff --git a/docs/reference/gtk/tmpl/gtkcelllayout.sgml b/docs/reference/gtk/tmpl/gtkcelllayout.sgml index 430c336ff8..39bf7c3209 100644 --- a/docs/reference/gtk/tmpl/gtkcelllayout.sgml +++ b/docs/reference/gtk/tmpl/gtkcelllayout.sgml @@ -32,6 +32,7 @@ GtkCellLayout @add_attribute: @set_cell_data_func: @clear_attributes: +@reorder: diff --git a/docs/reference/gtk/tmpl/gtkcellrenderer.sgml b/docs/reference/gtk/tmpl/gtkcellrenderer.sgml index fd36185868..eeaa62d017 100644 --- a/docs/reference/gtk/tmpl/gtkcellrenderer.sgml +++ b/docs/reference/gtk/tmpl/gtkcellrenderer.sgml @@ -66,6 +66,13 @@ it cannot be individually modified. + + + + + +@cellrenderer: the object which received the signal. + diff --git a/docs/reference/gtk/tmpl/gtkcellrenderertext.sgml b/docs/reference/gtk/tmpl/gtkcellrenderertext.sgml index 09056b7a2c..9a890809b9 100644 --- a/docs/reference/gtk/tmpl/gtkcellrenderertext.sgml +++ b/docs/reference/gtk/tmpl/gtkcellrenderertext.sgml @@ -94,6 +94,16 @@ Renders text in a cell + + + + + + + + + + @@ -119,6 +129,11 @@ Renders text in a cell + + + + + diff --git a/docs/reference/gtk/tmpl/gtkclipboard.sgml b/docs/reference/gtk/tmpl/gtkclipboard.sgml index a04634dc8a..a2ede06747 100644 --- a/docs/reference/gtk/tmpl/gtkclipboard.sgml +++ b/docs/reference/gtk/tmpl/gtkclipboard.sgml @@ -322,3 +322,4 @@ sgml-parent-document: ("../gtk-docs.sgml" "book" "refsect2" "") End: --> + diff --git a/docs/reference/gtk/tmpl/gtkmenushell.sgml b/docs/reference/gtk/tmpl/gtkmenushell.sgml index 9e08cab8ab..6ce095e335 100644 --- a/docs/reference/gtk/tmpl/gtkmenushell.sgml +++ b/docs/reference/gtk/tmpl/gtkmenushell.sgml @@ -166,6 +166,14 @@ Activates the menu item within the menu shell. after the menu item is activated. + + + + + +@menu_shell: + + An enumeration representing directional movements within a menu. diff --git a/docs/reference/gtk/tmpl/gtkmessagedialog.sgml b/docs/reference/gtk/tmpl/gtkmessagedialog.sgml index e93eb22f54..0857cdc58a 100644 --- a/docs/reference/gtk/tmpl/gtkmessagedialog.sgml +++ b/docs/reference/gtk/tmpl/gtkmessagedialog.sgml @@ -131,3 +131,12 @@ then call gtk_dialog_add_buttons(). @Returns: + + + + + +@message_dialog: +@str: + + diff --git a/docs/reference/gtk/tmpl/gtknotebook.sgml b/docs/reference/gtk/tmpl/gtknotebook.sgml index d2f35c20c6..ddc2d5a32a 100644 --- a/docs/reference/gtk/tmpl/gtknotebook.sgml +++ b/docs/reference/gtk/tmpl/gtknotebook.sgml @@ -201,6 +201,7 @@ The #GtkNotebookPage is an opaque implementation detail of #GtkNotebook. @notebook: @child: @tab_label: +@Returns: @@ -211,6 +212,7 @@ The #GtkNotebookPage is an opaque implementation detail of #GtkNotebook. @child: @tab_label: @menu_label: +@Returns: @@ -220,6 +222,7 @@ The #GtkNotebookPage is an opaque implementation detail of #GtkNotebook. @notebook: @child: the @tab_label: +@Returns: @@ -230,6 +233,7 @@ The #GtkNotebookPage is an opaque implementation detail of #GtkNotebook. @child: @tab_label: @menu_label: +@Returns: @@ -240,6 +244,7 @@ The #GtkNotebookPage is an opaque implementation detail of #GtkNotebook. @child: @tab_label: @position: +@Returns: @@ -251,6 +256,7 @@ The #GtkNotebookPage is an opaque implementation detail of #GtkNotebook. @tab_label: @menu_label: @position: +@Returns: diff --git a/docs/reference/gtk/tmpl/gtkpaned.sgml b/docs/reference/gtk/tmpl/gtkpaned.sgml index 45cd6a5c8f..c039e27f08 100644 --- a/docs/reference/gtk/tmpl/gtkpaned.sgml +++ b/docs/reference/gtk/tmpl/gtkpaned.sgml @@ -212,6 +212,24 @@ Adds a child to the bottom or right pane. @shrink: can this child be made smaller than its requsition. + + + + + +@paned: +@Returns: + + + + + + + +@paned: +@Returns: + + In older versions of GTK+, this function used to set the width of the diff --git a/docs/reference/gtk/tmpl/gtkradioaction.sgml b/docs/reference/gtk/tmpl/gtkradioaction.sgml index c32924d4da..9f1f607ddf 100644 --- a/docs/reference/gtk/tmpl/gtkradioaction.sgml +++ b/docs/reference/gtk/tmpl/gtkradioaction.sgml @@ -31,11 +31,29 @@ only private members and should not be accessed directly. @radioaction: the object which received the signal. @arg1: + + + + + + + + + + +@name: +@label: +@tooltip: +@stock_id: +@value: +@Returns: + + diff --git a/docs/reference/gtk/tmpl/gtksettings.sgml b/docs/reference/gtk/tmpl/gtksettings.sgml index e15fd0393d..3e00e1c300 100644 --- a/docs/reference/gtk/tmpl/gtksettings.sgml +++ b/docs/reference/gtk/tmpl/gtksettings.sgml @@ -45,6 +45,11 @@ Sharing settings between applications + + + + + diff --git a/docs/reference/gtk/tmpl/gtktoggleaction.sgml b/docs/reference/gtk/tmpl/gtktoggleaction.sgml index 7703aee732..356bc22bdf 100644 --- a/docs/reference/gtk/tmpl/gtktoggleaction.sgml +++ b/docs/reference/gtk/tmpl/gtktoggleaction.sgml @@ -34,6 +34,18 @@ private members and should not be accessed directly. + + + + + +@name: +@label: +@tooltip: +@stock_id: +@Returns: + + diff --git a/docs/reference/gtk/tmpl/gtktoolbar.sgml b/docs/reference/gtk/tmpl/gtktoolbar.sgml index d21fd9a404..7b695a98f6 100644 --- a/docs/reference/gtk/tmpl/gtktoolbar.sgml +++ b/docs/reference/gtk/tmpl/gtktoolbar.sgml @@ -44,6 +44,12 @@ The #GtkToolbar struct only contains private data and should only be accessed through the function described below. +@num_children: +@children: +@orientation: +@style: +@icon_size: +@tooltips: diff --git a/docs/reference/gtk/tmpl/gtktreemodelsort.sgml b/docs/reference/gtk/tmpl/gtktreemodelsort.sgml index fbd5fdf0c4..7b21248ad4 100644 --- a/docs/reference/gtk/tmpl/gtktreemodelsort.sgml +++ b/docs/reference/gtk/tmpl/gtktreemodelsort.sgml @@ -2,21 +2,124 @@ GtkTreeModelSort -A wrapper which makes an underlying tree model sortable +A GtkTreeModel which makes an underlying tree model sortable +The #GtkTreeModelSort is a model which implements the #GtkTreeSortable +interface. It does not hold any data itself, but rather is created with +a child model and proxies its data. It has identical column types to +this child model, and the changes in the child are propagated. The +primary purpose of this model is to provide a way to sort a different +model without modifying it. + + +The use of this is best demonstrated through an example. In the +following sample code we create two #GtkTreeView widgets each with a +view of the same data. As the model is wrapped here by a +#GtkTreeModelSort, the two #GtkTreeViews can each sort their +view of the data without affecting the other. By contrast, if we +simply put the same model in each widget, then sorting the first would +sort the second. + + + +Using a <structname>GtkTreeModelSort</structname> + +{ + GtkTreeView *tree_view1; + GtkTreeView *tree_view2; + GtkTreeModel *sort_model1; + GtkTreeModel *sort_model2; + GtkTreeModel *child_model; + + /* get the child model */ + child_model = get_my_model (); + + /* Create the first tree */ + sort_model1 = gtk_tree_model_sort_new_with_model (child_model); + tree_view1 = gtk_tree_view_new_with_model (sort_model1); + + /* Create the second tree */ + sort_model2 = gtk_tree_model_sort_new_with_model (child_model); + tree_view2 = gtk_tree_view_new_with_model (sort_model2); + + /* Now we can sort the two models independently */ + gtk_tree_sortable_set_sort_column_id (GTK_TREE_SORTABLE (sort_model1), + COLUMN_1, GTK_SORT_ASCENDING); + gtk_tree_sortable_set_sort_column_id (GTK_TREE_SORTABLE (sort_model2), + COLUMN_1, GTK_SORT_DESCENDING); +} + + + + +To demonstrate how to access the underlying child model from the sort +model, the next example will be a callback for the #GtkTreeSelection +"changed" signal. In this callback, we get a string from COLUMN_1 of +the model. We then modify the string, find the same selected row on the +child model, and change the row there. - + +Accessing the child model of in a selection changed callback + +void +selection_changed (GtkTreeSelection *selection, gpointer data) +{ + GtkTreeModel *sort_model = NULL; + GtkTreeModel *child_model; + GtkTreeIter sort_iter; + GtkTreeIter child_iter; + char *some_data = NULL; + char *modified_data; + + /* Get the current selected row and the model. */ + if (! gtk_tree_selection_get_selected (selection, + &sort_model, + &sort_iter)) + return; + + + /* Look up the current value on the selected row and get a new value + * to change it to. + */ + gtk_tree_model_get (GTK_TREE_MODEL (sort_model), &sort_iter, + COLUMN_1, &some_data, + -1); + + modified_data = change_the_data (some_data); + g_free (some_data); + + /* Get an iterator on the child model, instead of the sort model. */ + gtk_tree_model_sort_convert_iter_to_child_iter (GTK_TREE_MODEL_SORT (sort_model), + &child_iter, + &sort_iter); + + /* Get the child model and change the value of the row. In this + * example, the child model is a GtkListStore. It could be any other + * type of model, though. + */ + child_model = gtk_tree_model_sort_get_model (GTK_TREE_MODEL_SORT (sort_model)); + gtk_list_store_set (GTK_LIST_STORE (child_model), &child_iter, + COLUMN_1, &modified_data, + -1); + g_free (modified_data); +} + + + + + +#GtkTreeModel, #GtkListStore, #GtkTreeStore, #GtkTreeSortable, #GtkTreeModelFilter - +This should not be accessed directly. Use the accessor functions below. diff --git a/docs/reference/gtk/tmpl/gtktreeview.sgml b/docs/reference/gtk/tmpl/gtktreeview.sgml index 8d7bd7a8f6..e5e15ea11c 100644 --- a/docs/reference/gtk/tmpl/gtktreeview.sgml +++ b/docs/reference/gtk/tmpl/gtktreeview.sgml @@ -171,6 +171,11 @@ linkend="GtkTreeModel">GtkTreeModel interface. + + + + + diff --git a/docs/reference/gtk/tmpl/gtkuimanager.sgml b/docs/reference/gtk/tmpl/gtkuimanager.sgml index 1037f9ccbe..8355b05db4 100644 --- a/docs/reference/gtk/tmpl/gtkuimanager.sgml +++ b/docs/reference/gtk/tmpl/gtkuimanager.sgml @@ -199,6 +199,40 @@ members and should not be accessed directly. @uimanager: the object which received the signal. @widget: + + + + + +@uimanager: the object which received the signal. +@arg1: +@widget: + + + + + + +@uimanager: the object which received the signal. +@arg1: +@widget: + + + + + + +@uimanager: the object which received the signal. +@arg1: + + + + + + +@uimanager: the object which received the signal. +@arg1: + @@ -282,6 +316,16 @@ members and should not be accessed directly. @Returns: + + + + + +@self: +@types: +@Returns: + + diff --git a/docs/reference/gtk/tmpl/gtkwindow.sgml b/docs/reference/gtk/tmpl/gtkwindow.sgml index 261f7d30be..3414d41555 100644 --- a/docs/reference/gtk/tmpl/gtkwindow.sgml +++ b/docs/reference/gtk/tmpl/gtkwindow.sgml @@ -66,6 +66,11 @@ Toplevel which can contain other widgets @window: the object which received the signal. @widget: + + + + + @@ -702,6 +707,15 @@ Deprecated alias for gtk_window_set_position(). @setting: + + + + + +@window: +@setting: + + @@ -872,6 +886,15 @@ Deprecated alias for gtk_window_set_position(). @Returns: + + + + + +@window: +@Returns: + + diff --git a/docs/reference/gtk/tree_widget.sgml b/docs/reference/gtk/tree_widget.sgml index 4b16d4b93a..eb999e2919 100644 --- a/docs/reference/gtk/tree_widget.sgml +++ b/docs/reference/gtk/tree_widget.sgml @@ -15,47 +15,44 @@ Overview - To create a tree or list in GTK+, you need to use the GtkTreeModel interface, in + To create a tree or list in GTK+, use the GtkTreeModel interface in conjunction with the GtkTreeView widget. - - - This widget is designed around a - Model/View/Controller design and consists - of four major parts: + linkend="GtkTreeView">GtkTreeView widget. This widget is + designed around a Model/View/Controller + design and consists of four major parts: - the tree view widget (GtkTreeView) - the view column (GtkTreeViewColumn) - the cell renderers (GtkCellRenderer etc.) - and the model interface (GtkTreeModel) + The tree view widget (GtkTreeView) + The view column (GtkTreeViewColumn) + The cell renderers (GtkCellRenderer etc.) + The model interface (GtkTreeModel) - The View is composed of the first three, - while the last is the Model. One of the - prime benefits of the MVC design is that multiple views can be - created of a single model. For example, a model mapping the file - system could be created for a file manager. Many views could be - created to display various parts of the file system, but only one - copy need be kept in memory. + The View is composed of the first three + objects, while the last is the Model. One + of the prime benefits of the MVC design is that multiple views + can be created of a single model. For example, a model mapping + the file system could be created for a file manager. Many views + could be created to display various parts of the file system, + but only one copy need be kept in memory. The purpose of the cell renderers is to provide extensibility to the widget and to allow multiple ways of rendering the same type of data. - For example, consider how to render a boolean variable. Should you + For example, consider how to render a boolean variable. Should it render it as a string of "True" or "False", "On" or "Off", or should - you render it as a checkbox? + it be rendered as a checkbox? Creating a model - GTK+ 2.0 provides two types of models that can be used: - GtkListStore and - GtkTreeStore. GtkListStore is - used to model columned list widgets, while GtkTreeStore models - columned tree widgets. It is possible to develop a new type of model, - but the existing models should be satisfactory for all but the most - specialized of situations. Creating the model is quite simple: + GTK+ provides two simple models that can be used: the GtkListStore and the GtkTreeStore. GtkListStore is used + to model list widgets, while the GtkTreeStore models trees. It + is possible to develop a new type of model, but the existing + models should be satisfactory for all but the most specialized of + situations. Creating the model is quite simple: